home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / ldgetname.z / ldgetname
Encoding:
Text File  |  1998-10-30  |  2.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDGGGGEEEETTTTNNNNAAAAMMMMEEEE((((3333XXXX))))                                                    LLLLDDDDGGGGEEEETTTTNNNNAAAAMMMMEEEE((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldgetname - retrieve symbol name for object file symbol table entry
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmm....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  16.  
  17.      cccchhhhaaaarrrr ****llllddddggggeeeettttnnnnaaaammmmeeee ((((ldptr, symbol))))
  18.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  19.      ppppSSSSYYYYMMMMRRRR ****symbol;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _l_d_g_e_t_n_a_m_e returns a pointer to the name associated with _s_y_m_b_o_l as a
  23.      string.  The string is contained in a static buffer.  Because the buffer
  24.      can be overwritten by later calls to _l_d_g_e_t_n_a_m_e, the caller must copy the
  25.      buffer if the name is to be saved.
  26.  
  27.      If the name cannot be retrieved, _l_d_g_e_t_n_a_m_e returns NNNNUUUULLLLLLLL (defined in
  28.      <<<<ssssttttddddiiiioooo....hhhh>>>>) for an object file.  This occurs when:
  29.  
  30.  
  31.      +o    the string table cannot be found
  32.  
  33.      +o    the name's offset into the string table is beyond the end of the
  34.           string table
  35.  
  36.  
  37.      Typically, _l_d_g_e_t_n_a_m_e is called immediately after a successful call to
  38.      _l_d_t_b_r_e_a_d. _l_d_g_e_t_n_a_m_e retrieves the name associated with the symbol table
  39.      entry filled by _l_d_t_b_r_e_a_d.
  40.  
  41.      The program must be loaded with the object file access routine library
  42.      lllliiiibbbbmmmmlllldddd....aaaa.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(4).
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.